home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / NEWSOFT / AUGUST / FREETIME / !FreeTime / !Help next >
Text File  |  1997-06-20  |  5KB  |  142 lines
  1. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2. +                                        +
  3. +    !FreeTime  -  A Freenet Time Client     (c) Joseph Heenan 1997     +
  4. +                                    +
  5. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  6.  
  7. Version 1.03
  8. ~~~~~~~~~~~~
  9.  
  10. FreeTime is a simple program that uses the internet time protocol
  11. (see RFC 868) to read the time from a remote time server.
  12.  
  13. Once the time has been read, it will compare it with the time on your
  14. local computer. If the times differ by less than a specified amount,
  15. (5 seconds by default) it doesn't set your computers clock.
  16.  
  17. If the times differ by more than a specified amount (120 seconds by
  18. default), then FreeTime will bring up a window enquiring whether
  19. or not it should set your computers clock. (This is to guard against
  20. it setting the time to something totally wrong!)
  21.  
  22. Otherwise, it sets you local clock so that it agrees with the time
  23. from the remote server, and brings up a window saying to - which
  24. disappears either after 5 seconds, or when you click on it.
  25.  
  26. You can configure when freetime will bring up it's window - see
  27. below for details!
  28.  
  29. FreeTime quits once it has completed its job.
  30.  
  31. Configuring
  32. ~~~~~~~~~~~
  33.  
  34. All freetimes configurable options are changed by editting the
  35. file '!FreeTime.Config'.
  36.  
  37. This is a text file, with the following format:
  38.  
  39.  All lines beginning with #'s are comments.
  40.  All other lines are the options, with the format 'tag:value'
  41.  
  42. The tags are as follows:
  43.  
  44. Server  : This specifies which computer to fetch the time from - by
  45.           default, it uses ntp.demon.co.uk, which is fine for demon
  46.           customers. Other people should use a machine belonging to
  47.           their internet service provider - you should contact them
  48.           directly if you are unsure of its name.
  49.  
  50. MaxDiff : This is a time, in seconds. If the difference between the
  51.           remote time server and your local clock is more than this,
  52.           freetime will pop up a window asking whether or not to
  53.           set the clock (providing the 'out' flag is set in the
  54.           'Window' tag, below).
  55.  
  56. MinDiff : This is again, a time in seconds. If the time difference
  57.           between the remote time server and your clock is less than
  58.           this, freetime will not set your clock.
  59.  
  60. Timeout : Another time in seconds - this is how long to wait for a
  61.           reply from the time server before giving up. If you have
  62.           a slow link, you may want to increase this from the default.
  63.  
  64. Display : This specifies how long to display the information window
  65.           for - the default is five seconds.
  66.  
  67. Window  : This is a series of words, specifying when FreeTime should
  68.           display what has happened to the user. If the word is
  69.           is listed after Window:, it means display 'this' to the
  70.           user. The words are:
  71.  
  72.             transfer : Display window while fetching time from the server
  73.             error    : Display window if an error occurs
  74.             set      : Display window whenever time is set
  75.             min      : Display window if difference between times is less
  76.                          than the value set in 'MinDiff:', above.
  77.             out      : Display a query to the user if the times differ
  78.                          by more than the value in 'MaxDiff:'
  79.  
  80.           I'd recommend always having 'error' and 'out' included. I also
  81.           include 'set' in my Config file.
  82.  
  83.  
  84. Usage with Acornet
  85. ~~~~~~~~~~~~~~~~~~
  86.  
  87. To get FreeTime to run each time you connect to the internet with Acornet,
  88. edit the file !Acornet.Utils.!SLIPdial.Scripts.acornet.Acornet:
  89.  
  90. Goto line 63 (Just after the line reading ':LinkUp')
  91. Insert this line so it's after the :LinkUp line:
  92.  
  93. task /name=FreeTime "Run Acornet:Apps.!FreeTime"
  94.  
  95. Save, and move !FreeTime in !Acornet.Apps.
  96.  
  97. NB. I don't use Acornet myself, but I've been told this method works.
  98.  
  99. Licence :
  100. ~~~~~~~
  101.  
  102. !FreeTime is © Copyright 1996-1997 Joseph Heenan. All rights are reserved.
  103.  
  104. Permission is granted to use FreeTime on the understanding that this use is
  105. entirely at your own risk. I accept no liability whatsoever for any loss or
  106. damage arising from the use of FreeTime nor do I make any guarantee that it
  107. is fit for any purpose.  FreeTime maybe freely distributed providing all files 
  108. are present and unchanged.  No charges may be made for distribution.  It
  109. should not be distributed as part of any packages or CD's without the authors
  110. express permission.
  111.  
  112. Credits :
  113. ~~~~~~~
  114.  
  115. Carol Carpenter for beta testing and useful suggestions, Ben Dooks for
  116. showing me the basics of udp and Matthew Bloch and Jim Gilligan for
  117. beta testing.
  118.  
  119. And a special thankyou to everyone who reported the BST bug!
  120.  
  121. History
  122. ~~~~~~~
  123.  
  124. v1.01 : First release, Acorn User April '97 cover disc
  125. v1.02 : Bug fix for BST
  126. v1.03 : Added errno 486, no internet stack available
  127.         Added Acornet instructions
  128.  
  129.  
  130. Contact Details :
  131. ~~~~~~~~~~~~~~~
  132.  
  133. If you find any bugs, or have any suggestions for new features,
  134. or any general comments, please contact me via email:
  135.  
  136.     Joseph@odie.barnet.ac.uk
  137.  
  138. I also read comp.sys.acorn.networking, so post there if you feel
  139. it appropriate.
  140.  
  141. Joseph Heenan.
  142.